Developer Documentation

QuickTime 4 API Documentation

Wired Movies and Sprites

| Previous | Chapter Contents | Chapter Top | Next |

Sprites Functions Specific to Wired Sprites

The following routines are specific to sprite tracks using wired sprites. For more information on wired sprites, see "Introduction to Wired Movies, Sprites, and the Sprite Toolbox."


SpriteMediaSetActionVariable

The SpriteMediaSetActionVariable function sets the value of the sprite track variable with the ID of the variable to the supplied value.

pascal ComponentResult SpriteMediaSetActionVariable
                     (MediaHandler mh,
                                         QTAtomID variableID,
                                         const float *value);

mh
Specifies the sprite media handler for this operation.

variableID
Specifies a variable ID of the sprite name.

value
Contains a pointer to a floating-point number. Note that the value is passed by reference.


SpriteMediaGetActionVariable

The SpriteMediaGetActionVariable returns the value of the sprite track variable with the specified ID.

pascal ComponentResult SpriteMediaGetActionVariable(
                     MediaHandler mh,
                                         QTAtomID variableID,
                                         float *value);

mh
Specifies the sprite media handler for this operation.

variableID
Specifies a variable ID of the sprite variable.

value
Contains a pointer to a floating-point value. If the specified variable has never been set, the value is set to 0 and the error cannotFindAtomErr is returned.


© 1999 Apple Computer, Inc.

| Previous | Chapter Contents | Chapter Top | Next |